W01-2. 컨테이너 기초 - 실습 가이드
1주차 실습: 컨테이너를 직접 만져 보기
강의 노트에서 들은 내용을 내 노트북에서 직접 확인합니다.
- 컨테이너가 1초 안에 뜨고 메모리를 아주 조금 쓰는 것
- 컨테이너 안에서는 자기 자신만 보이는 것 (격리된 프로세스)
- 모든 컨테이너가 커널 하나를 같이 쓰는 것
- 컨테이너를 지우면 안에서 바꾼 내용이 사라지는 것
- 사전 준비의 5. 최종 점검까지 마쳐야 합니다.
- Docker Desktop 이 실행 중이어야 합니다(대시보드 왼쪽 아래 Engine running).
- 터미널: macOS → 터미널 / Windows → PowerShell
- 아래 명령어는 macOS 와 Windows 가 똑같습니다. 다른 부분만 따로 표시했습니다.
| 실습 | 내용 | 시간 |
|---|---|---|
| 1 | 첫 컨테이너: hello-world 가 하는 일 | 5분 |
| 2 | 다른 리눅스를 1초 만에: Ubuntu 와 Alpine | 5분 |
| 3 | 컨테이너 안으로 들어가 보기 | 7분 |
| 4 | 커널은 하나다: uname 으로 확인 |
5분 |
| 5 | 컨테이너 = 격리된 프로세스 | 7분 |
| 6 | 웹 서버 3대를 1초 만에 | 8분 |
| 7 | 컨테이너는 지우면 사라진다 | 5분 |
| 8 | 정리 | 3분 |
실습 1. 첫 컨테이너: hello-world 가 하는 일
docker run --rm hello-world
출력 예시 (주요 부분):
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.
출력 해석: 강의 노트 6장의 그림이 그대로 일어났습니다.
| 단계 | 의미 |
|---|---|
| 1 | docker 명령(CLI)이 Docker 엔진(daemon)에게 요청을 보냈습니다 |
| 2 | 엔진이 Docker Hub 에서 hello-world 이미지를 받았습니다(pull). 이미 받아 둔 이미지라면 이 단계는 건너뜁니다 |
| 3 | 엔진이 이미지로 컨테이너를 만들어 실행했습니다 |
| 4 | 컨테이너가 출력한 글자를 내 터미널로 보내 줬습니다 |
(amd64) 부분은 사람마다 다릅니다
- Windows / Intel Mac:
(amd64) - Apple Silicon Mac(M 시리즈):
(arm64v8)
내 노트북 CPU 종류에 맞는 이미지를 Docker 가 알아서 골라 받습니다. 이 차이는 4주차에 다시 다룹니다.
명령어 뜯어보기:
docker run --rm hello-world
# │ │ │ └─ 실행할 이미지 이름
# │ │ └─ --rm : 컨테이너가 끝나면 자동으로 삭제 (실습 찌꺼기 방지)
# │ └─ run : 이미지로 컨테이너를 만들고 실행
# └─ docker CLI
실습 2. 다른 리눅스를 1초 만에: Ubuntu 와 Alpine
내 노트북에 리눅스를 설치하지 않았는데도, 서로 다른 리눅스를 바로 실행할 수 있습니다.
docker run --rm ubuntu:26.04 cat /etc/os-release
출력 예시 (앞부분):
PRETTY_NAME="Ubuntu 26.04.1 LTS"
NAME="Ubuntu"
VERSION_ID="26.04"
VERSION="26.04.1 LTS (Resolute Raccoon)"
docker run --rm alpine:3.24 cat /etc/os-release
출력 예시 (앞부분):
NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.24.2
cat /etc/os-release 는 "이 리눅스가 무엇인지" 알려 주는 파일을 출력하는 명령입니다.
이미지 이름 뒤에 실행할 명령을 붙이면, 컨테이너는 그 명령 하나만 실행하고 바로 끝납니다.
이미지 크기도 비교해 봅니다.
docker image ls ubuntu:26.04
docker image ls alpine:3.24
출력 예시:
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
ubuntu:26.04 da6fc2be5478 160MB 45.3MB
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
alpine:3.24 294b683cb724 13MB 3.94MB
| 열 | 의미 |
|---|---|
| DISK USAGE | 압축을 풀어 내 디스크에 차지하는 크기 |
| CONTENT SIZE | 내려받은(압축된) 크기 |
Ubuntu 서버용 VM 이미지는 보통 수 GB 입니다. 그런데 Ubuntu 컨테이너 이미지는 160MB, Alpine 은 13MB 입니다.
이렇게 작을 수 있는 이유는? → 커널이 없기 때문입니다. 커널은 호스트 것을 같이 씁니다(실습 4에서 확인).
실습 3. 컨테이너 안으로 들어가 보기
-it 옵션을 주면 컨테이너 안의 셸(명령 창)을 내 터미널에서 직접 쓸 수 있습니다.
docker run -it --rm ubuntu:26.04 bash
프롬프트가 아래처럼 바뀌면 컨테이너 안입니다. @ 뒤의 글자는 사람마다 다릅니다.
root@f9de64d417b6:/#
컨테이너 안에서 아래 명령을 하나씩 입력합니다.
hostname # 컨테이너의 호스트 이름 (= 컨테이너 ID 앞 12자리)
ls / # 리눅스 기본 폴더 구조가 다 있음
ps # 실행 중인 프로세스 목록
출력 예시:
root@f9de64d417b6:/# hostname
f9de64d417b6
root@f9de64d417b6:/# ls /
bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr var
root@f9de64d417b6:/# ps
PID TTY TIME CMD
1 ? 00:00:00 bash
8 ? 00:00:00 ps
ps 결과를 잘 보세요
내 노트북에서는 수백 개의 프로그램이 돌고 있습니다. 그런데 컨테이너 안에서는 bash 와 방금 친 ps 둘만 보입니다.
게다가 bash 가 PID 1번입니다. 강의 노트의 Namespace(칸막이) 가 바로 이것입니다.
다 봤으면 컨테이너에서 나옵니다.
exit
--rm을 줬기 때문에exit하면 컨테이너는 자동으로 지워집니다.
| 옵션 | 의미 |
|---|---|
-i (interactive) |
키보드 입력을 컨테이너로 전달 |
-t (tty) |
터미널 화면처럼 보이게 함 (프롬프트, 줄바꿈) |
-it |
위 둘을 같이 쓴 것. "컨테이너 안에 들어가서 작업" 할 때 항상 씁니다 |
실습 4. 커널은 하나다: uname 으로 확인
uname -r 은 커널 버전을 알려 주는 명령입니다. 서로 다른 두 리눅스에서 실행해 봅니다.
docker run --rm ubuntu:26.04 uname -r
docker run --rm alpine:3.24 uname -r
출력 예시 (Windows):
6.6.87.2-microsoft-standard-WSL2
6.6.87.2-microsoft-standard-WSL2
출력 예시 (macOS): 숫자는 다를 수 있고, 끝에 linuxkit 이 붙습니다.
x.x.xx-linuxkit
x.x.xx-linuxkit
- Ubuntu 와 Alpine 은 서로 다른 리눅스인데 커널 버전이 똑같습니다. → 두 컨테이너가 같은 커널 하나를 공유한다는 증거입니다.
- 내 노트북은 Windows / macOS 인데 리눅스 커널이 나옵니다. → Docker Desktop 이 띄운 작은 리눅스 VM 의 커널입니다.
- Windows:
microsoft-standard-WSL2(WSL 2 의 리눅스 커널) - macOS:
linuxkit(Docker Desktop 이 쓰는 리눅스)
- Windows:
옆 사람과 비교해 봅시다. CPU 종류도 확인합니다.
docker run --rm alpine:3.24 uname -m
| 노트북 | 출력 |
|---|---|
| Windows / Intel Mac | x86_64 |
| Apple Silicon Mac | aarch64 |
Apple Silicon Mac 에서 만든 이미지는 기본적으로 arm64 용입니다. 그대로 x86_64 서버에 올리면 실행이 안 될 수 있습니다.
우리 스터디는 Mac 과 Windows 가 섞여 있으니, 4주차에 두 CPU 에서 모두 도는 이미지를 만드는 법을 배웁니다.
실습 5. 컨테이너 = 격리된 프로세스
이번에는 컨테이너를 백그라운드로 띄워 두고, 바깥과 안에서 각각 들여다봅니다.
docker run -d --name study-sleeper alpine:3.24 sleep 3600
| 옵션 | 의미 |
|---|---|
-d (detach) |
백그라운드로 실행하고 터미널을 바로 돌려줌 |
--name study-sleeper |
컨테이너에 이름을 붙임 (없으면 Docker 가 아무 이름이나 붙임) |
sleep 3600 |
3600초(1시간) 동안 그냥 기다리는 명령 |
출력 예시: 긴 글자는 컨테이너 ID 입니다.
5a050c26a993d3c2...
5-1. 지금 떠 있는 컨테이너 목록
docker ps
출력 예시:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
5a050c26a993 alpine:3.24 "sleep 3600" 5 seconds ago Up 4 seconds study-sleeper
5-2. 바깥(Docker 엔진)에서 본 모습
docker top study-sleeper
출력 예시:
UID PID PPID C STIME TTY TIME CMD
root 4493 4470 0 04:17 ? 00:00:00 sleep 3600
5-3. 컨테이너 안에서 본 모습
docker exec 는 이미 실행 중인 컨테이너 안에서 명령을 하나 더 실행합니다.
docker exec study-sleeper ps
출력 예시:
PID USER TIME COMMAND
1 root 0:00 sleep 3600
7 root 0:00 ps
| 보는 위치 | sleep 3600 의 PID |
|---|---|
바깥 (docker top) |
4493 (사람마다 다름) |
안 (docker exec ... ps) |
1 |
같은 프로세스인데 보는 위치에 따라 번호가 다릅니다.
컨테이너는 VM 처럼 따로 부팅한 컴퓨터가 아니라, 리눅스 위의 평범한 프로세스에 칸막이를 친 것이기 때문입니다.
실습 6. 웹 서버 3대를 1초 만에
nginx 웹 서버 컨테이너 3개를 동시에 띄워 봅니다.
docker run -d --name study-web-1 -p 8081:80 nginx:1.30-alpine
docker run -d --name study-web-2 -p 8082:80 nginx:1.30-alpine
docker run -d --name study-web-3 -p 8083:80 nginx:1.30-alpine
-p 8081:80 이 뭔가요? (3주차에 자세히)
내 노트북의 8081번 포트로 들어온 요청을 컨테이너의 80번 포트로 전달하라는 뜻입니다.
컨테이너 3개가 모두 안에서는 80번을 쓰지만, 바깥 포트를 8081 / 8082 / 8083 으로 다르게 줘서 충돌하지 않습니다.
6-1. 브라우저로 접속
브라우저에서 아래 주소를 하나씩 엽니다.
세 곳 모두 Welcome to nginx! 페이지가 보이면 성공입니다.
6-2. 자원 사용량 확인
docker stats --no-stream study-web-1 study-web-2 study-web-3
출력 예시:
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS
2e5af9b92753 study-web-1 0.00% 10.29MiB / 7.304GiB 0.14% ... ... ...
... study-web-2 0.00% 10.3MiB / 7.304GiB 0.14% ... ... ...
... study-web-3 0.00% 10.26MiB / 7.304GiB 0.14% ... ... ...
웹 서버 3대를 VM 으로 띄우면, VM 마다 OS 를 부팅해야 하고 OS 몫의 메모리도 각각 필요합니다.
컨테이너는 웹 서버 하나에 약 10MB 입니다. LIMIT 은 Docker Desktop 의 리눅스 VM 에 할당된 메모리라서 사람마다 다릅니다.
6-3. 시작 시간 재 보기
컨테이너 하나를 만들고, 명령을 실행하고, 지우기까지 걸리는 시간을 잽니다.
macOS:
time docker run --rm alpine:3.24 echo "hello container"
출력 예시: 맨 끝의 total 이 전체 걸린 시간(초)입니다. 숫자는 사람마다 다릅니다.
hello container
docker run --rm alpine:3.24 echo "hello container" 0.03s user 0.02s system 4% cpu 0.879 total
Windows (PowerShell):
Measure-Command { docker run --rm alpine:3.24 echo "hello container" } | Select-Object TotalSeconds
출력 예시:
TotalSeconds
------------
0.6698654
실습 노트북 기준 1초가 안 걸립니다. VM 부팅과 비교해 보세요.
실습 7. 컨테이너는 지우면 사라진다
Ubuntu 이미지에는 curl(웹 요청 도구)이 없습니다. 컨테이너 안에 설치해 보겠습니다.
7-1. 컨테이너 안에 curl 설치
docker run -it --name study-ubuntu ubuntu:26.04 bash
이번에는
--rm을 빼고 이름을 붙였습니다. 나와도 컨테이너가 남아 있게 하려는 것입니다.
컨테이너 안에서:
apt-get update
apt-get install -y curl
curl -sI https://www.docker.com | head -1
exit
출력 예시 (마지막 curl 결과):
HTTP/2 200
7-2. 새 컨테이너에서 curl 을 찾아보기
docker run --rm ubuntu:26.04 bash -c "command -v curl || echo 'curl 없음'"
출력 예시:
curl 없음
새 컨테이너는 언제나 이미지 상태 그대로 시작합니다. 앞에서 설치한 curl 은 study-ubuntu 컨테이너 안에만 있습니다.
7-3. 앞 컨테이너에서 무엇이 바뀌었는지 보기
docker diff study-ubuntu
출력 예시 (앞부분):
C /etc
A /etc/gss
A /etc/gss/mech.d
...
| 기호 | 의미 |
|---|---|
A |
Added: 새로 생긴 파일 / 폴더 |
C |
Changed: 바뀐 파일 / 폴더 |
D |
Deleted: 지워진 파일 / 폴더 |
이제 이 컨테이너를 지웁니다.
docker rm study-ubuntu
컨테이너를 지우면 docker diff 에 나온 변경 내용도 함께 사라집니다.
그래서 실무에서는 아래처럼 합니다.
- 필요한 프로그램은 이미지에 미리 넣는다 → 4주차 Dockerfile
- 남겨야 하는 데이터는 컨테이너 밖에 둔다 → 3주차 볼륨
실습 8. 정리
오늘 만든 컨테이너를 모두 지웁니다. 이름이 study- 로 시작하는 것만 지우므로 다른 작업물은 안전합니다.
docker rm -f study-sleeper study-web-1 study-web-2 study-web-3
| 옵션 | 의미 |
|---|---|
docker rm |
컨테이너 삭제 (멈춘 것만 지울 수 있음) |
-f (force) |
실행 중인 것도 멈추고 바로 삭제 |
남은 컨테이너가 있는지 확인합니다.
docker ps -a
-a는 멈춘 컨테이너까지 모두 보여 줍니다.study-로 시작하는 것이 하나도 없으면 정리 끝입니다. ✅
이미지(ubuntu:26.04등)는 다음 주에도 쓰니 지우지 않습니다.
자주 나는 문제와 해결
| 증상 | 원인 | 해결 |
|---|---|---|
Bind for 0.0.0.0:8081 failed: port is already allocated |
그 포트를 다른 컨테이너나 프로그램이 이미 쓰는 중 | 다른 포트(예: -p 8091:80)로 바꿉니다. 실패해도 컨테이너가 "Created" 상태로 남으니 docker rm <이름> 으로 지운 뒤 다시 실행합니다 |
Conflict. The container name "/study-web-1" is already in use |
같은 이름의 컨테이너가 이미 있음 (멈춘 것 포함) | docker rm -f study-web-1 후 다시 실행 |
-it 로 들어갔는데 빠져나오는 법을 모르겠음 |
- | exit 입력 (또는 Ctrl + D) |
Windows 에서 cat: can't open 'C:/Program Files/Git/...' |
Git Bash 를 쓰고 있음 | PowerShell 로 다시 실행 (사전 준비 4-1 참고) |
toomanyrequests |
Docker Hub 받기 제한 | docker login 확인 |
오늘 쓴 명령어 정리
| 명령어 | 하는 일 |
|---|---|
docker run <이미지> [명령] |
이미지로 컨테이너를 만들고 실행 |
docker run --rm ... |
끝나면 컨테이너 자동 삭제 |
docker run -it ... bash |
컨테이너 안에 들어가서 작업 |
docker run -d --name <이름> ... |
이름을 붙여 백그라운드로 실행 |
docker run -p 8081:80 ... |
내 PC 8081 → 컨테이너 80 연결 |
docker ps / docker ps -a |
실행 중인 / 모든 컨테이너 목록 |
docker exec <이름> <명령> |
실행 중인 컨테이너 안에서 명령 실행 |
docker top <이름> |
컨테이너의 프로세스를 바깥에서 보기 |
docker stats --no-stream |
컨테이너 자원 사용량 |
docker diff <이름> |
이미지 대비 바뀐 파일 |
docker image ls |
내려받은 이미지 목록 |
docker rm [-f] <이름> |
컨테이너 삭제 |
복습 과제
확인 퀴즈
- VM 과 컨테이너의 가장 큰 구조적 차이는 무엇인가요?
- 실습 4에서 Ubuntu 와 Alpine 의
uname -r결과가 같았던 이유는? - 실습 5에서 같은
sleep프로세스의 PID 가 바깥에서는 4493, 안에서는 1이었습니다. 어떤 커널 기능 때문인가요? - 컨테이너 안에서 설치한
curl이 새 컨테이너에는 없었던 이유는? - macOS / Windows 노트북에서 리눅스 컨테이너가 돌아가는 원리는?
- VM 은 게스트 OS(커널 포함)를 통째로 가지고 있고, 컨테이너는 게스트 OS 없이 호스트의 커널을 공유합니다.
- 두 컨테이너가 같은 커널 하나(Docker Desktop 리눅스 VM 의 커널)를 같이 쓰기 때문입니다. 이미지에는 커널이 들어 있지 않습니다.
- Namespace(PID 네임스페이스). 컨테이너 안에서는 자기만의 PID 번호 체계를 봅니다.
- 새 컨테이너는 항상 이미지 상태 그대로 시작하고, 설치 내용은 이전 컨테이너의 쓰기 영역에만 있었기 때문입니다.
- Docker Desktop 이 노트북 안에 가벼운 리눅스 VM 을 띄우고, 그 안에서 컨테이너를 실행합니다(Windows 는 WSL 2).
도전 과제 (선택)
-
docker run -d --name study-web -p 8080:80 nginx:1.30-alpine으로 띄운 뒤,docker exec -it study-web sh로 들어가서 아래처럼 첫 페이지를 바꿔 보세요. 그리고 http://localhost:8080 을 새로고침해 보세요.echo '<h1>Hello from my container!</h1>' > /usr/share/nginx/html/index.html exit -
그 컨테이너를 지우고(
docker rm -f study-web) 같은 명령으로 다시 띄우면 첫 페이지는 어떻게 될까요? 이유도 설명해 보세요. -
Docker Desktop 대시보드의 Containers 화면에서 실행 중인 컨테이너의 Logs, Exec, Stats 탭을 눌러 보세요. 오늘 터미널로 한 일을 화면으로도 할 수 있습니다.
오늘은 docker run 하나로 많은 것을 했습니다. 다음 주에는 컨테이너의 생명주기(생성 → 실행 → 정지 → 삭제)와 로그 보기, 이미지 관리를 체계적으로 익힙니다.
네비게이션
| 이전 | 목록 | 다음 |
|---|---|---|
| ◀ 1주차 강의 노트 | 목록으로 | 2주차 강의 노트 ▶ |